home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / programr / menuba.zip / MENUBAR.TXT < prev    next >
Text File  |  1992-01-26  |  12KB  |  276 lines
  1.            Menubar button control library(MENUBAR.DLL)
  2.  
  3.                           Users manual 
  4.                          Release  1.00 
  5.  
  6.                         February 1, 1992
  7.                        Copyright (c) 1992 
  8.  
  9.                               by  
  10.   
  11.                               MRL 
  12.   
  13.                         1200 Stonehurst 
  14.                    Huntsville, Alabama 35801  
  15.                                  
  16.                        All Rights Reserved
  17.  
  18. This file provides the information needed by a Windows developer
  19. to utilize the menubar.dll library. Menubar.dll is a copyrighted
  20. product of MRL and all rights are reserved. Any and all usage must
  21. be in accordance with terms discussed in section III or this
  22. documentation. No usage other than for evaluation is permitted
  23. without registration. User feedback including comments/questions
  24. are welcome. Please address your comments to MRL via Compuserve ID
  25. [73637,737] or via mail to 1200 Stonehurst, Huntsville, AL., 35801.
  26.  
  27.                   Restrictions and Warranties 
  28.  
  29. The software described herein is furnished under a license
  30. agreement. The software may be used or copied only in accordance
  31. with the terms of the applicable agreement. The purchaser may make
  32. one copy of the software for backup purposes. Unregistered copies
  33. of menubar.dll are for evaluation purposes only, and may be
  34. distributed through normal shareware channels.  Please distribute
  35. these evaluation copies to other bulletin boards and users.
  36. Menubar.dll may be uploaded to and downloaded from commercial
  37. systems such as CompuServe, the Source, and BIX, as long as there
  38. is no charge for the product itself.  Those copying, sharing,
  39. and/or electronically transmitting this product are required not
  40. to delete or modify the copyright notice and restrictive notices
  41. from the program or documentation. Any distribution of menubar.dll
  42. must include all files contained in the packed format. Commercial
  43. vendors and distributors of "public domain" or user-supported
  44. software libraries may distribute copies of menubar.dll unless
  45. notified by MRL to cease distribution of the product. Only nominal
  46. fees associated with copying and handling (not to exceed $5 US) may
  47. be charged by anyone providing unregistered copies. Menubar.dll may
  48. not be utilized or distributed as a promotion for any commercial
  49. venture. 
  50.  
  51. Information in this document is subject to change without notice
  52. and does not represent a commitment on the part of either MRL. 
  53.  
  54. To use menubar.dll, you need the following: 
  55.   
  56.           IBM PC (or compatible)-286 with 1 Mbyte. 
  57.  
  58.           Microsoft Windows (version 3.0 or later)  
  59.   
  60.              MS-DOS/PC-DOS (version 3.0 or a later version required
  61.           by your version of Microsoft Windows)  
  62.   
  63.           Windows SDK or other development environment. 
  64.  
  65. Use of this product for any period of time constitutes your 
  66. acceptance of this agreement and subjects you to its contents.   
  67.  
  68.   
  69. EXCEPT AS PROVIDED IN PART IV OF THIS MANUAL, MRL DISCLAIMS ALL 
  70. WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED
  71. TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  72. PARTICULAR PURPOSE, WITH RESPECT TO THE PRODUCT. SHOULD THE PROGRAM
  73. PROVE DEFECTIVE, THE PURCHASER ASSUMES THE RISK OF PAYING THE
  74. ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION AND
  75. ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES.  IN NO EVENT WILL MRL BE
  76. LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION
  77. DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS
  78. OF BUSINESS INFORMATION AND THE LIKE) ARISING OUT OF THE USE OR THE
  79. INABILITY TO USE THIS PRODUCT. 
  80.     Table of Contents                                         
  81. I. Concepts .................................................4  
  82. II. Specification of Options.................................5 
  83. IV. Registration and License Fees...........................10
  84.  
  85.                           I. CONCEPT
  86. Menubar.dll provides a custom control that may be utilized with any
  87. MS Windows development environment that has a resource compiler.
  88. It allows the developer capabilities to easily define toolbar
  89. controls within a dialogue box and execute predefined commands upon
  90. clicking of a portion of the toolbar. Any menubar may contain
  91. multiple bitmap resources that independently control individual
  92. commands. The menubar may be combined as part of a dialogue to
  93. create sets of commands, combo boxes, list boxes, etc. Multiple
  94. menubars may be included within a dialogue. Each menubar may extend
  95. either horizontally or vertically and have multiple rows (or
  96. columns) of bitmap commands.   I.II. Specification of Options
  97.  
  98. This section describes how the developer specifies the menubar
  99. capabilities for different methods of creating the resource script
  100. commands. Three options for specification are discussed including
  101. a text script,the Microsoft Dialogue editor, and the Whitewater
  102. Resource Toolkit. The messages a user may send from his program are
  103. discussed in section 4.0. In addition, the IMPORT section of the
  104. .DEF must contain an import for menubarWndFn. See test.def for
  105. examples of all features.
  106.  
  107. 1.0 Text Script Definition
  108.  
  109.  
  110. The developer may specify a menubar.dll control by including it in
  111. the resource text script that is processed by the resource
  112. compiler. This is the most efficient way to make minor changes that
  113. do not require spacing of dialogue fields. It may be the only way
  114. to specify the focus option. To include a menubar.dll button, add
  115. a field with the class "menubar", include the menudefs.h file in
  116. the resource script and specify the text information and control
  117. style option as described in this section.
  118.  
  119. 1.1 Text Specification
  120.  
  121. The user may describe the set of bitmaps and commands as the text
  122. string associated with the control. The format of the string is:
  123.  
  124. {text,}N1,N2,XXX{:YYY},{XXX{:YYY}}
  125.  
  126. where 
  127.     N1    is the number of bitmaps columns
  128.     N2    is the number of bitmaps rows 
  129.     XXX    is the name of a bitmap resource within the users
  130.           resource file 
  131.      YYY    is the number of a user command to be executed when
  132.           bitmap area is selected
  133.  
  134. The fields within brackets are optional. The user should specify
  135. a text literal to be displayed if he selects the WS_CAPTION style
  136. option.
  137.  
  138. 1.2 Style Specification
  139.  
  140. The menubar control has one unique style attribute. The BM_FOCUS
  141. attribute allows the user to specify that a menubar control is a
  142. selection of one of the bitmaps (similar to the WS_GROUP options
  143. for RADIO buttons. This will result in the bitmap being highlighted
  144. when selected and remaining highlighted until another bitmap within
  145. the menubar is selected. Default mode is not to highlight bitmaps
  146. when selected.
  147. 2.0 Microsoft Dialogue Editor
  148.  
  149. A dialogue is provided for using the microsoft dialogue editor. The
  150. menubar.dll must be installed as a custom control by the ADD CUSTOM
  151. CONTROL menu option. The user can specify all of the options via
  152. this dialogue except for focus. The menubar output from the
  153. dialogue editor does not specify focus option. To select the focus
  154. option, edit the output file using any text editor and specify the
  155. BM_FOCUS style. Note that user resource bitmaps and commands are
  156. specified following the button text separated by a comma. These are
  157. not displayed within the dialogue editor since the resource file
  158. is not available.
  159.  
  160. 3.0 Whitewater Resource Toolkit (WRT)
  161.  
  162. The WRT contains a single predefined dialogue of custom controls.
  163. To use it, you must specify the class name , text description as
  164. you would in a text file (see section 1.0). The limitation on text
  165. length may make if more desireable to enter the actual bitmap names
  166. and commands after creation of the text file via text editor.
  167.  
  168. 4.0 User Command Messages
  169.  
  170. The user program may issue two commands to menubar.dll vis the send
  171. message function. These and associated functions are:
  172.  
  173. MB_FOCUSMSG    This message sets the focus option for the menubar.
  174.                A value of TRUE (non-zero) for wParam means the
  175.                menubar will display a focus rectangle around the
  176.                selected bitmap. This is desireable when the menubar
  177.                commands are parameters set by the program that
  178.                remain in effect. A FALSE (or zero) value does not
  179.                display focus rectangles. This is the default. The
  180.                lParam field is not used.
  181.  
  182. MS_SETITEM    This message allows the user program to dynamically
  183.                change the menubar item bitmap and command. The user
  184.                is responsible for loading the bitmap. The wParam
  185.                parameter identifies the bitmap number (0-n). The
  186.                low word of the lParam parameter specified the
  187.                bitmap handle, while the high word specifies the
  188.                command. 
  189.              III. REGISTRATION AND LICENSE FEES 
  190.   
  191. Menubar.dll must be registered if utilized for other than 
  192. evaluation purposes for a period not to exceed sixty (30) days. A
  193. separate copy is required for each PC utilized for user program
  194. development. Multiple copies may be distributed with user programs
  195. at a single site. Multiple site distribution requires purchase of
  196. copies for each site or a commercial distribution license. The file
  197. menubar.frm provides a sample form to be printed and included with
  198. payment or send your name, company, and address to
  199. MRL, 1200 Stonehurst Drive, Huntsville, Al, 35801.
  200.   
  201. 1.  Registration Costs  
  202.   
  203. Current rates for prepaid orders (in US dollars) are as follows: 
  204.   
  205. $20.00       Single user registration/license fee 
  206. $50.00       Commercial Distribution license
  207.            (Up to 200 Copies)(see below) 
  208. $250.00      Commercial Distribution license 
  209.            (Over 200 Copies)(see below) 
  210. $300.00      Source code (may not be distributed) 
  211.  
  212. Commercial Distribution is limited in the following manner: 
  213.  
  214. -       It must be part of a user developed product. 
  215. -       It may be utilized for toolbars within that product. 
  216. -       The product must not include capabilities for user 
  217.         generation of dynamically definable toolbars. 
  218. -       The name of the dll must be changed. 
  219.  
  220. For commercial distribution rights in the above cases please
  221. contact MRL. 
  222.  
  223. Residents of Alabama and Huntsville must add appropriate Sales 
  224. Tax.   
  225.  
  226. The scheduled rates and charges are current as of the date of 
  227. this manual.  All fees and charges are subject to change without
  228. notice.  
  229.   
  230. Multiple Purchase registrations are available pursuant to the
  231. following schedules.  
  232.  
  233. Total Copies Registered (on one order)   Percent Discount 
  234.    
  235.             ------------                  ------------  
  236.   
  237.              1 to    5                             0% 
  238.  
  239.              6 to   10                            15% 
  240.   
  241.             10 to   99                            40% 
  242.    
  243.            100 to  499                            50% 
  244.            
  245.            500 to  999                            60% 
  246.  
  247.           1000 or more                            70% 
  248.  
  249.   
  250. As stated herein, there are no warranties whatsoever associated 
  251. with the menubar.dll software product, and we are not responsible
  252. for its performance.  You are the sole judge of the product's 
  253. effectiveness and suitability for your particular purposes, and 
  254. are given an opportunity to pre-evaluate same via shareware 
  255. distribution.  
  256.  
  257. We can only accept drafts, checks, international money orders or
  258. travelers checks payable in U. S. dollars drawn on U.S. banks. 
  259. Registration can also be paid by credit card, Visa or Master Card.
  260.  
  261. Registered users will be notified when updates and new products 
  262. are  available.  Anyone wishing to offer advice and suggestions 
  263. are most welcome to do so.  
  264.  
  265. Questions, errors, and suggestions for product improvements are 
  266. welcome, either mail these to MRL, 1200 Stonehurst Drive, 
  267. Huntsville, AL, 35801 or transmit them via CIS to ID 73637,737. 
  268. CIS is the quickest method of receiving response. Be sure to
  269. include: 
  270.   
  271. -    The version of the copy of menubar.dll that you are using. 
  272. -    DOS and Windows versions that you are using;  
  273. -    hardware configuration (model, memory size, printer, etc.) 
  274. -    Windows or standard DOS applications that you may be running
  275. or have loaded under Windows at the same time.  
  276.